package com.vehiclemanagement.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.vehiclemanagement.entity.FuelRefill;

import java.math.BigDecimal;
import java.time.LocalDateTime;
import java.util.List;
import java.util.Map;

/**
 * 加油记录服务接口
 */
public interface FuelRefillService extends IService<FuelRefill> {
    
    /**
     * 分页查询加油记录
     * 
     * @param current 当前页
     * @param size 每页记录数
     * @param searchTerm 搜索关键词
     * @param vehicleId 车辆ID（可选）
     * @param driverId 驾驶员ID（可选）
     * @param fuelCardId 加油卡ID（可选）
     * @param fuelType 油品类型（可选）
     * @param startTime 开始时间（可选）
     * @param endTime 结束时间（可选）
     * @return 分页结果
     */
    IPage<FuelRefill> pageRefills(Integer current, Integer size, String searchTerm, 
                                 Long vehicleId, Long driverId, Long fuelCardId, Integer fuelType,
                                 LocalDateTime startTime, LocalDateTime endTime);
    
    /**
     * 根据ID获取加油记录
     * 
     * @param id 加油记录ID
     * @return 加油记录
     */
    FuelRefill getRefillById(Long id);
    
    /**
     * 添加加油记录，同时更新加油卡余额
     * 
     * @param refill 加油记录
     * @return 是否成功
     */
    boolean addRefill(FuelRefill refill);
    
    /**
     * 更新加油记录
     * 
     * @param refill 加油记录
     * @return 是否成功
     */
    boolean updateRefill(FuelRefill refill);
    
    /**
     * 删除加油记录
     * 
     * @param id 加油记录ID
     * @return 是否成功
     */
    boolean deleteRefill(Long id);
    
    /**
     * 统计某辆车的总加油量
     * 
     * @param vehicleId 车辆ID
     * @return 总加油量
     */
    BigDecimal sumFuelAmountByVehicleId(Long vehicleId);
    
    /**
     * 统计某辆车的总加油金额
     * 
     * @param vehicleId 车辆ID
     * @return 总加油金额
     */
    BigDecimal sumTotalPriceByVehicleId(Long vehicleId);
    
    /**
     * 统计月度加油费用
     * 
     * @param year 年份
     * @return 月度加油费用统计
     */
    List<Map<String, Object>> statisticsByMonth(Integer year);
} 